home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / grafik / amiwin / x11 / man / xclock.man < prev    next >
Encoding:
Text File  |  1996-07-16  |  5.6 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XCLOCK(1)                USER COMMANDS                  XCLOCK(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      xclock - analog / digital clock for X
  10.  
  11. SYNOPSIS
  12.      xclock [ -help ] [ -analog ] [ -digital ] [ -chime ]  [  -hd
  13.      color  ] [ -hl color ] [ -update seconds ] [ -padding number
  14.      ]
  15.  
  16. DESCRIPTION
  17.      The xclock program displays the time in  analog  or  digital
  18.      form.  The time is continuously updated at a frequency which
  19.      may be specified by the user.
  20.  
  21. OPTIONS
  22.      Xclock accepts all of the standard X  Toolkit  command  line
  23.      options along with the additional options listed below:
  24.  
  25.      -help   This option indicates that a brief  summary  of  the
  26.              allowed  options  should  be printed on the standard
  27.              error.
  28.  
  29.      -analog This option indicates that a  conventional  12  hour
  30.              clock face with tick marks and hands should be used.
  31.              This is the default.
  32.  
  33.      -digital or -d
  34.              This option indicates that a 24 hour  digital  clock
  35.              should be used.
  36.  
  37.      -chime  This option indicates that the  clock  should  chime
  38.              once on the half hour and twice on the hour.
  39.  
  40.      -hands color (or -hd color)
  41.              This option specifies the color of the hands  on  an
  42.              analog clock.  The default is black.
  43.  
  44.      -highlight color (or -hl color)
  45.              This option specifies the color of the edges of  the
  46.              hands  on  an  analog  clock,  and is only useful on
  47.              color displays.  The default is black.
  48.  
  49.      -update seconds
  50.              This option specifies the frequency  in  seconds  at
  51.              which  xclock  should  update  its  display.  If the
  52.              clock is obscured  and  then  exposed,  it  will  be
  53.              updated  immediately.  A value of 30 seconds or less
  54.              will enable a second hand on an analog  clock.   The
  55.              default is 60 seconds.
  56.  
  57.      -padding number
  58.              This option specifies the width  in  pixels  of  the
  59.              padding  between the window border and clock text or
  60.  
  61.  
  62.  
  63. X Version 11         Last change: Release 6                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XCLOCK(1)                USER COMMANDS                  XCLOCK(1)
  71.  
  72.  
  73.  
  74.              picture.  The default is 10 on a digital clock and 8
  75.              on an analog clock.
  76.  
  77. X DEFAULTS
  78.      This program uses the Clock widget.  It understands  all  of
  79.      the core resource names and classes as well as:
  80.  
  81.      width (class Width)
  82.              Specifies the width of the clock.  The  default  for
  83.              analog clocks is 164 pixels; the default for digital
  84.              clocks is whatever is needed to hold the clock  when
  85.              displayed in the chosen font.
  86.  
  87.      height (class Height)
  88.              Specifies the height of the clock.  The default  for
  89.              analog clocks is 164 pixels; the default for digital
  90.              clocks is whatever is needed to hold the clock  when
  91.              displayed in the chosen font.
  92.  
  93.      update (class Interval)
  94.              Specifies the frequency in seconds at which the time
  95.              should be redisplayed.
  96.  
  97.      foreground (class Foreground)
  98.              Specifies the color for the tic marks.  The  default
  99.              is depends on whether reverseVideo is specified.  If
  100.              reverseVideo is specified  the  default  is  lwhite,
  101.              otherwise the default is black.
  102.  
  103.  
  104.      hands (class Foreground)
  105.              Specifies the color of the insides  of  the  clock's
  106.              hands.  The default is depends on whether reverseVi-
  107.              deo is specified.  If reverseVideo is specified  the
  108.              default is lwhite, otherwise the default is black.
  109.  
  110.      highlight (class Foreground)
  111.              Specifies the color used to  highlight  the  clock's
  112.              hands. The default is
  113.               depends on whether reverseVideo is  specified.   If
  114.              reverseVideo  is  specified  the  default is lwhite,
  115.              otherwise the default is black.
  116.  
  117.      analog (class Boolean)
  118.              Specifies whether or not an analog clock  should  be
  119.              used instead of a digital one.  The default is True.
  120.  
  121.      chime (class Boolean)
  122.              Specifies whether or not a bell should  be  rung  on
  123.              the hour and half hour.
  124.  
  125.      padding (class Margin)
  126.  
  127.  
  128.  
  129. X Version 11         Last change: Release 6                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XCLOCK(1)                USER COMMANDS                  XCLOCK(1)
  137.  
  138.  
  139.  
  140.              Specifies the amount of internal padding  in  pixels
  141.              to be used.  The default is 8.
  142.  
  143.      font (class Font)
  144.              Specifies the font to be used for the digital clock.
  145.              Note  that  variable  width fonts currently will not
  146.              always display correctly.
  147.  
  148. WIDGETS
  149.      In order to specify resources, it  is  useful  to  know  the
  150.      hierarchy of the widgets which compose xclock.  In the nota-
  151.      tion below, indentation  indicates  hierarchical  structure.
  152.      The widget class name is given first, followed by the widget
  153.      instance name.
  154.  
  155.      XClock  xclock
  156.           Clock  clock
  157.  
  158.  
  159. ENVIRONMENT
  160.      DISPLAY to get the default host and display number.
  161.  
  162.      XENVIRONMENT
  163.              to get the name of a resource  file  that  overrides
  164.              the  global resources stored in the RESOURCE_MANAGER
  165.              property.
  166.  
  167. FILES
  168.      <XRoot>/lib/X11/app-defaults/XClock  -  specifies   required
  169.      resources
  170.  
  171. SEE ALSO
  172.      X(1), xrdb(1), time(3C)
  173.  
  174. BUGS
  175.      Xclock believes the system clock.
  176.  
  177.      When in digital mode, the string should be centered automat-
  178.      ically.
  179.  
  180. AUTHORS
  181.      Tony Della Fera (MIT-Athena, DEC)
  182.      Dave Mankins (MIT-Athena, BBN)
  183.      Ed Moy (UC Berkeley)
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. X Version 11         Last change: Release 6                     3
  196.  
  197.  
  198.  
  199.